package com.ryder.subject.infra.basic.service;

import com.ryder.subject.infra.basic.entity.SubjectInfo;

import java.util.List;

/**
 * 描述: 题目信息表(SubjectInfo)表服务接口
 *
 * @author Ryder
 * @version 1.0
 * @since 1.0 // 版本号，指明从哪个版本开始
 * 更新日期: 2025-02-05
 */

public interface SubjectInfoService {

    /**
     * 通过ID查询单条数据
     *
     * @param id 主键
     * @return 实例对象
     */
    SubjectInfo queryById(Long id);

    /**
     * 新增数据
     *
     * @param subjectInfo 实例对象
     * @return 实例对象
     */
    SubjectInfo insert(SubjectInfo subjectInfo);

    /**
     * 修改数据
     *
     * @param subjectInfo 实例对象
     * @return 实例对象
     */
    SubjectInfo update(SubjectInfo subjectInfo);

    /**
     * 通过主键删除数据
     *
     * @param id 主键
     * @return 是否成功
     */
    boolean deleteById(Long id);

    /**
     * 根据条件查询数据 所有的数量
     *
     * @param subjectInfo 实例对象
     * @return 实例对象
     */
    int countByCOndition(SubjectInfo subjectInfo, Long categoryId, Long labelId);

    /**
     * 分页查询
     *
     * @param subjectInfo 实例对象
     * @return 对象列表
     */
    List<SubjectInfo> queryPage(SubjectInfo subjectInfo, Long categoryId, Long labelId, int start, Integer pageSize);

    /**
     * 获取贡献者数量
     *
     * @return 对象列表
     */
    List<SubjectInfo> getContributeCount();

    /**
     * 获取上题或者下题 cursor 1下 0上
     *
     * @return 对象列表
     */
    Long querySubjectIdCursor(Long subjectId, Long categoryId, Long labelId, int cursor);

}
